std::literals::string_literals::operator""s

Определено в заголовке `<string>`
	(1)
std::string operator""s( const char* str, std::size_t len );		(с C++14) (до C++20)
constexpr std::string operator""s( const char* str, std::size_t len );		(с C++20)
constexpr std::u8string operator""s( const char8_t* str, std::size_t len );	(2)	(с C++20)
	(3)
std::u16string operator""s( const char16_t* str, std::size_t len );		(с C++14) (до C++20)
constexpr std::u16string operator""s( const char16_t* str, std::size_t len );		(с C++20)
	(4)
std::u32string operator""s( const char32_t* str, std::size_t len );		(с C++14) (до C++20)
constexpr std::u32string operator""s( const char32_t* str, std::size_t len );		(с C++20)
	(5)
std::wstring operator""s( const wchar_t* str, std::size_t len );		(с C++14) (до C++20)
constexpr std::wstring operator""s( const wchar_t* str, std::size_t len );		(с C++20)

Формирует строковый литерал нужного типа.

1) Возвращает std::string{str, len}.

2) Возвращает std::u8string{str, len}.

3) Возвращает std::u16string{str, len}.

4) Возвращает std::u32string{str, len}.

5) Возвращает std::wstring{str, len}.

Параметры

str	-	указатель на начало литерала необработанного массива символов
len	-	длина литерала необработанного массива символов

Возвращаемое значение

Строковый литерал.

Примечания

Эти операторы объявлены в пространстве имён std::literals::string_literals, где как literals, так и string_literals являются вложенными пространствами имён. Доступ к этим операторам можно получить, используя либо

using namespace std::literals, или
using namespace std::string_literals, или
using namespace std::literals::string_literals.

std::chrono::duration также определяет operator""s, для представления литералов секунд, но это арифметический литерал: 10.0s и 10s — это десять секунд, но "10"s — это строка.

Тест на наличие функции макрос	Значение	Std	Функция
`__cpp_lib_string_udls`	201304L	(C++14)	Пользовательские литералы для строковых типов

Пример

#include <iostream>
#include <string>
 
void print_with_zeros(auto const note, std::string const& s)
{
    std::cout << note;
    for (const char c : s)
        c ? std::cout << c : std::cout << "₀";
    std::cout << " (size = " << s.size() << ")\n";
}
 
int main()
{
    using namespace std::string_literals;
 
    std::string s1 = "abc\0\0def";
    std::string s2 = "abc\0\0def"s;
    print_with_zeros("s1: ", s1);
    print_with_zeros("s2: ", s2);
 
    std::cout << "abcdef"s.substr(1,4) << '\n';
}

Вывод:

s1: abc (size = 3)
s2: abc₀₀def (size = 8)
bcde

См. также

(конструктор)	строит `basic_string` (публичный член-функция)
operator""sv (C++17)	создает строку-просмотр литерала массива символов (функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/operator%22%22s